Skip to content

phase5-E: smoke + evidence; Phase 5 closed#39

Merged
rafael5 merged 1 commit into
mainfrom
phase5-E
May 11, 2026
Merged

phase5-E: smoke + evidence; Phase 5 closed#39
rafael5 merged 1 commit into
mainfrom
phase5-E

Conversation

@rafael5
Copy link
Copy Markdown
Contributor

@rafael5 rafael5 commented May 11, 2026

Summary

Track E of phase5-plan.md §6. Phase 5 close-out — ships docs/ai-discoverability/phases/phase5-evidence.md capturing clean runs of every Phase-5 gate plus the companion gates from earlier phases.

Evidence captured

Gate Result
pytest profile/build/ 116 / 116
make check-freshness (Track A) clean — worst=OK
make check-links (Track B, offline) clean — 59 URLs catalogued
make check-licenses (Track C, offline) clean — worst=SKIP
make check-schema-compat (Track D) clean — no bumps
make handshake (Phase 3) 8 / 8 steps
make recipes-check (Phase 3) 4 / 4 clean
make validate-catalog (Phase 1) OK
make check-docs-prose (Phase 0) clean

All seven §10 done-criteria cited green

# Criterion PR / commit
1 check-freshness.py + TDD + make target PR #32 / e9e00cb
2 check-links.py + TDD + B0 binary-URL fix PR #33 / 16bbd08
3 check-licenses.py + TDD + signature dict (10 repos) PR #34 / 5d9a995
4 check-schema-compat.py + TDD + fetch-depth:0 wiring PR #35 / 8792787
5 CI per-PR runs all four --offline variants (4 PRs above)
6 Weekly cron runs --strict freshness + live link-check + full LICENSE-fetch (Tracks A/B/C in the handshake job)
7 phase5-evidence.md captures clean runs this PR

Companion updates

  • docs/ai-discoverability/README.md phase table — Phase 5 row flipped from "in flight" → "Closed 2026-05-11" with the evidence link.
  • AI-discoverability-architecture.md "Phase 5 — in flight" section rewritten to "Phase 5 — closed 2026-05-11"; notes the operational loop is complete and future phases would address growth, not enforcement coverage.

What this completes

Pre-Phase-5, verified_on correctness, URL liveness, declared-license accuracy, and schema-compat discipline lived in maintainer heads. Post-Phase-5, each has an automated gate. PR-mode runs the cheap --offline variants on every push/PR; the existing weekly Monday-14:00-UTC cron firing runs the full-fetch variants so upstream drift surfaces within 7 days (the parent-plan §7 Phase-5 exit criterion).

Out-of-scope follow-ups (noted in evidence doc)

  • Live-fetch freshness mode (re-read upstream repo.meta.json per cron rather than committed-catalog verified_on).
  • run-recipe.py's minimal YAML parser limitation (> block scalars / [] inline arrays).
  • Multi-license per-file SPDX detection.

None blocks Phase 5 close.

Test plan

  • All four Phase-5 gates green locally
  • Companion gates (handshake / recipes-check / validate-catalog / check-docs-prose) still green
  • 116/116 pytest
  • CI green

Captures Phase 5 exit per phase5-plan.md §6 + §10. Mirrors
phase4-evidence.md shape: one section per gate, "what this proves"
roll-up, then each §10 done-criterion cited green.

Verified locally (gate outputs in the evidence doc):

* pytest profile/build/ — 116/116 (51 prior + 65 across Phase 5)
* make check-freshness — clean (worst=OK)
* make check-links — clean (offline; 59 URLs catalogued)
* make check-licenses — clean (worst=SKIP; 9 INVENTORIED + 1 SKIP
  for m-modern-corpus's mixed-per-subdir)
* make check-schema-compat — clean (no bumps in this PR; no non-
  additive changes)
* make handshake — 8/8 steps
* make recipes-check — 4/4 clean
* make validate-catalog — OK
* make check-docs-prose — clean

All seven §10 done-criteria cited green in the evidence doc:

1. check-freshness.py + 15 TDD + make target (PR #32 / e9e00cb)
2. check-links.py + 13 TDD + B0 binary-URL fix in
   validate-repo-meta.py + 5 TDD (PR #33 / 16bbd08)
3. check-licenses.py + 18 TDD + per-license signature dict (PR #34
   / 5d9a995)
4. check-schema-compat.py + 14 TDD + fetch-depth:0 wiring (PR #35
   / 8792787)
5. CI per-PR runs all four --offline variants
6. Weekly cron firing runs --strict freshness + live link-check +
   full LICENSE-fetch
7. This evidence file

Also:

* docs/ai-discoverability/README.md phase table — Phase 5 row
  flipped from "in flight" → "Closed 2026-05-11" with evidence link.
* AI-discoverability-architecture.md "Phase 5 — in flight" section
  rewritten to "Phase 5 — closed 2026-05-11"; notes the operational
  loop is complete and future phases would address growth, not
  enforcement coverage.
@rafael5 rafael5 merged commit 4bc23e2 into main May 11, 2026
2 checks passed
@rafael5 rafael5 deleted the phase5-E branch May 11, 2026 16:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant